<!DOCTYPE html>
<html>
	<head>
		<title>macOS Setup</title>

		<meta name="keywords" content="guide, mac, macos, osx, setup">
		<meta name="viewport" content="width=device-width, initial-scale=1">

		<link rel="stylesheet" href="../../_assets/css/foundation.css">
		<link rel="stylesheet" href="../../_assets/css/prism.css">
		<link rel="stylesheet" href="../../_assets/css/style.css">
		<link href='http://fonts.googleapis.com/css?family=Open+Sans:400,300,600,700' rel='stylesheet' type='text/css'>		
	</head>

	<body id="guide-contents" class="language-c++">

		<!-- CONTENT STARTS HERE -->

		<h1>macOS Setup</h1>
		<p>This short guide will walk you through getting Cinder running on your macOS machine. You'll need Xcode 11.3.1 or later. In general this is best installed through the App Store, and is <a href="https://itunes.apple.com/us/app/xcode/id497799835?mt=12">available here</a>.</p>

		<p>If you are using one of our <a href="https://libcinder.org/download">packaged releases</a>, you already have everything you need. If you're working from GitHub you'll want to follow the build instructions in our <a href="../git/index.html">Cinder + Git</a> guide.</p>

		<p>To test your installation, we'll build one of the samples. From the Finder, navigate to the <em>samples/_opengl/CubeMapping</em> folder and open <em>xcode/CubeMapping.xcodeproj</em> by double-clicking it. From the <strong>Product</strong> menu select the <strong>Run</strong> item. Xcode will take a few seconds to build the sample and then it should launch and look similar to the screenshot below.</p>

		<center><img class="shadow" alt="CubeMapping Sample" src="images/cubemapping_sample.jpg"></center>
		
		<br />
		
		<h2>Creating New Projects</h2>
		<p><a href="../tinderbox/index.html">TinderBox</a> is Cinder's GUI tool for creating new projects quickly and easily. A guide to creating projects using TinderBox is <a href="../tinderbox/index.html">available here</a>.</p>

		<h2>Debug Symbols</h2>
		<p>While not strictly necessary, if you're working from a prepackaged release and would like to be able to step into Cinder's own code during your debug process, you'll want to build Cinder with debug symbols. This is straightforward - just open <em>xcode/cinder.xcodeproj</em> in Xcode and build the Debug configuration for the Cinder target. If you are doing iOS development you'll want to do the same thing for the <em>cinder_iphone</em> and <em>cinder_iphone_sim</em> targets.</p>
				
		<h2>Cinder + Git</h2>
		<p>If you would like to keep up with the latest Cinder development, the project is <a href="https://github.com/cinder">hosted on GitHub</a>. A guide for setting up Cinder using git is <a href="../git/index.html">available here</a>.</p>
		
		<!-- END CONTENT -->

		<!-- Scripts -->
		<script src="../../_assets/js/prism.js" type="text/javascript"></script>

	</body>
</html> 